This subsystem controls the system error correction and manages calibration kits.
Command tree: [SENSe<Ch>:]CORRection:COLLect
[:ACQuire]
:RSAVe
:DEFault
:SELected
:AUTO
:CKIT
:PORTs
:CONNection
:DELete
:METHod
:DEFine
:SAVE
:SCONnection
Program example: Calibration
Starts a calibration measurement in order to acquire measurement data for the selected standards. The standards are reflection or transmission standards and must be connected to port 1 or 2 of the analyzer.
Use the generalized command [SENSe<Ch>:]CORRection:COLLect[:ACQuire]:SELected to obtain measurement data at arbitrary analyzer ports.
<Ch>
Channel number of the calibrated channel. If unspecified the numeric suffix is set to 1.
THRough ... UTHRough
Standard types: Through, Open, Short, Match (MATCH12 and IMATCH12 are synonymous), Symmetric Network (NET), Attenuation (ATT), Reflect, Sliding Match (SLIDe), Line, Match/Open (M1O2, O1M2), Match/Short (M1S2, S1M2), Open/Short (OSHort), Unknown Through (UTHRough).
The numbers in the parameters denote the analyzer ports. Two numbers 12 mean that two separate calibrations are performed at ports 1 and 2.
*RST value
ON
<Dispersion>
Optional status parameter for UTHRough standard:
OFF – Unknown through standard is non-dispersive ON – Unknown through standard is non-dispersive
OFF
AUTO | <delay | phase>
Optional entry of delay time or phase for UTHRough standard:
AUTO – The analyzer determines the delay time or phase during the calibration sweep <delay or phase> – entry of the delay time in ps (for non-dispersive standards) or of an estimate of the phase at the start frequency of the sweep in deg (for dispersive standards). If an estimate of the start phase is entered, the analyzer uses the calculated value which is closest to the estimate.
AUTO
SCPI, Command Types
Confirmed (with device-specific standards), no query
Example:
See [SENSe<Ch>:]CORRection:COLLect:SAVE.
Activates or deactivates the calibration mode where the raw measurement data of the standards is stored after the calibration is completed. The setting is valid for the current calibration, where it overwrites the global setting ([SENSe<Ch>:]CORRection:COLLect[:ACQuire]:RSAVe:DEFault). A new calibration deletes the calibration data acquired in previous calibrations.
Channel number of the calibrated channel.
<Boolean>
ON | OFF - Keep measurement data on or off.
Device-specific, command or query
CORR:COLL:RSAV:DEF ON
Generally keep the raw measurement data of the standards after the calibration is completed.
CORR:COLL:METH:DEF 'Test',RSHort,1
Select a one-port normalization at port 1 with a short standard as calibration type.
CORR:COLL:SEL SHOR,1
Measure a short standard connected to port 1 and store the raw measurement results of this standard.
CORR:COLL:RSAV OFF
To save disk space, delete the current raw calibration data after the calibration is completed.
CORR:COLL:SAVE:SEL
Calculate the system error correction data and apply them to the active channel.
Activates or deactivates the calibration mode where the raw measurement data of the standards is stored after the calibration is completed. The setting remains valid for all subsequent calibrations until it is changed explicitly. A new calibration deletes the calibration data acquired in previous calibrations.
See [SENSe<Ch>:]CORRection:COLLect[:AQUire]:RSAVe.
Starts a calibration measurement in order to acquire measurement data for the selected standards. The standards are reflection or transmission standards and can be connected to arbitrary analyzer ports.
Standard types: Through, Open, Short, Match, Symmetric Network (NET), Attenuation (ATT), Reflect, Sliding Match (SLIDe), Line, Unknown Through.
<port_no>
Port numbers of the analyzer. For a transmission standard (through, line, attenuation, symmetric network) the input and output port numbers must be specified, for reflection standards, only one port number is required.
–
AUTO – The analyzer determines the delay time or phase during the calibration sweep <delay or phase> – entry of the delay time in ps (for non-dispersive standards) or of the phase at the start frequency of the sweep in deg (for dispersive standards)
Device-specific, no query
See [SENSe<Ch>:]CORRection:COLLect:SAVE:SELected.
Selects and initiates a one-port, two-port, three-port or four-port automatic calibration at arbitrary analyzer and cal unit ports.
If the test setup contains a high attenuation the analyzer may fail to detect the cal unit ports connected to each of its ports. In this case use the extended command [SENSe<Ch>:]CORRection:COLLect:AUTO:PORTs.
If several calibration units are connected, use SYSTem:COMMunicate:RDEVice:AKAL:ADDRess to select a unit for the calibration.
'<file_name>'
Name and (possibly) directory of the cal kit file to be used for the automatic calibration (string parameter):
If nothing is specified (empty string ' '), the default cal kit file stored in the calibration unit is used. This file is also used in manual control.
A NWA cal kit file name *.calkit without path denotes a specific cal kit file stored in the Calibration Unit.
A NWA cal kit file name *.calkit with path denotes a specific cal kit file stored in an arbitrary directory.
Port numbers of the analyzer. For an n-port automatic calibration (n = 1 to 4), n arbitrary (not necessarily consecutive) port numbers must be specified. The analyzer automatically detects the calibration unit ports connected to each analyzer port.
CORR:COLL:AUTO '', 1, 2, 4
Perform an automatic 3-port TOSM calibration at test ports 1, 2, and 4 using the calibration unit's default calibration kit file and arbitrary test ports of the cal unit.
Generate a cal kit file with the specified name containing the cal kit data of the active calibration unit (SYSTem:COMMunicate:RDEVice:AKAL:ADDRess). The cal kit file can be stored in the calibration unit or written to a directory on the analyzer.
Channel number of the calibrated channel (not relevant for this command).
Name and (possibly) directory of the created cal kit file (string parameter, extension *.calkit):
If no path and directory is specified, the file is stored in the calibration unit (see also [SENSe<Ch>:]CORRection:COLLect:AUTO). The factory calibration data on the unit is not overwritten.
If a path and directory is specified, the file is stored in the directory on the analyzer's hard disk.
The default directory (MMEMory:CDIRectory) is not used.
CORR:COLL:AUTO:CKIT 'AutoCalChar.calkit'
Generate a cal kit file AutoCalChar.calkit for the active calibration unit and store it internally.
Selects and initiates a one-port, two-port, three-port or four-port automatic calibration at arbitrary analyzer and calibration unit ports.
This command is necessary if the analyzer fails to detect the cal unit ports connected to each of its ports (e.g. because of a high attenuation in the test setup). If auto-detection works you can use the simpler command [SENSe<Ch>:]CORRection:COLLect:AUTO.
If nothing is specified (empty string ' '), the default cal kit file stored in the calibration unit is used. This file should be used to operate the calibration unit like in manual control; specifying another cal kit file is primarily for service purposes.
<analyzer_port_no>
Port numbers of the analyzer. For an n-port automatic calibration (n = 1 to 4), n arbitrary (not necessarily consecutive) port numbers must be specified.
<cal_unit__port_no>
Port numbers of the cal unit. For an n-port automatic calibration (n = 1 to 4), n arbitrary (not necessarily consecutive) port numbers must be specified. It is possible to combine arbitrary (not necessarily matching) pairs of analyzer and cal unit ports.
CORR:COLL:AUTO:PORT '', 1, 2, 2, 4, 4, 1
Perform an automatic 3-port TOSM calibration at the analyzer test ports 1, 2, and 4 using the calibration unit's default calibration kit file and ports 2, 4, and 1 of the cal unit.
Returns the assignment between the network analyzer ports and the ports of the connected automatic calibration unit.
Device-specific, query only
CORR:COLL:AUTO:PORT:CONN?
Query the actual port assignment. If the cal unit is properly connected according to the previous command, the response is 1,2,2,4,3,0,4,1. A zero means that the corresponding analyzer port is not connected to any port of the calibration unit.
Selects a connector type at a specified port <port_no> and its gender.
Use [SENSe<Ch>:]CORRection:COLLect:SCONnection<port_no> to select an arbitrary connector type using a string variable.
Port numbers of the analyzer.
Note: If the analyzer is set to use the same connectors at all ports ([SENSe<Ch>:]CORRection:COLLect:CONNection<port_no>:PORTs ALL), then a change of a connector type is valid for all ports. The gender of the connectors can still be different.
Parameters
Connector type and gender of the connectors (omitted for query). UFEMALE1 and UMALE1 denote the user-defined connector type UserConn1, UFEMALE2 and UMALE2 denote the user-defined connector type UserConn2. SMAFEMALE and SMAMALE denote the user-defined connector type SMA. The user-defined connector types must be defined before being addressed by [SENSe<Ch>:]CORRection:COLLect:CONNection<port_no>.
N50FEMALE for all ports.
Device-specific, command or query.
*RST; CORR:COLL:CONN1 N75MALE; CONN4?
Change the connector type at port 1 from N50FEMALE to N75MALE. The connector type at the other ports is also changed to N75, however, the gender (female) is maintained. CORR:COLL:CONN4? returns N75FEMALE.
Qualifies whether the connector types at the analyzer ports (but not their gender) are equal or independent.
In the present firmware version, a calibration must be performed using the same connector type at all ports. Use [SENSe<Ch>:]CORRection:COLLect:CONNection<port_no>:PORTs SINGle if you want to perform a measurement with independent port connectors.
ALL: Equal (uniform) connector types. If the connector type at one port is changed, the connector type at all other ports is changed accordingly. SINGle: Independent (possibly non-uniform) connector types at the ports.
Port numbers of the analyzer. This parameter has no effect because the setting affects all ports.
ALL
CORR:COLL:CONN:PORTS SING
Select independent connector types at the ports.
CORR:COLL:CONN1 N50MALE; CONN4 N75FEMALE; CONN2?
Select independent connector types at ports 1 and 4. The connector type at port 2 is not changed; the query returns N50FEMALE.
Deletes system error correction data generated and stored previously.
'<cal_name>'
Name of the calibration (string parameter) defined together with calibration type [SENSe<Ch>:]CORRection:COLLect:METHod:DEFine. If nothing is specified the analyzer deletes the last system error correction stored by means of [SENSe<Ch>:]CORRection:COLLect:SAVE.
Measure a short standard connected to port 1 and store the measurement results of this standard.
CORR:COLL:SAVE; DEL
Calculate the system error correction data and apply them to the active channel, then delete the data.
Selects a one-port or two-port calibration type at ports 1/2.
Use the generalized command [SENSe<Ch>:]CORRection:COLLect:METHod:DEFine to select the calibration type for arbitrary analyzer ports or a multiport calibration type.
Calibration types: TOM, TRM, TRL, TNA, TOSM, Full One Port, One Path Two Port, Normalization (REFL1, REFL2 and REFL12 for one-port, TPORT for two-port), TOSM with unknown through.
The numbers in the parameters denote the analyzer ports. Parameters for two-port calibration types contain no numbers because the command is only valid for ports 1 and 2.
Confirmed (with device-specific calibration types), command or query. If several calibration types are assigned to channel <Ch>, the query returns a list of all calibration types.
Selects a one-port, two-port, three-port or four-port calibration type at arbitrary analyzer ports.
Name of the calibration (string parameter). The name serves as a reference to delete a particular set of system correction data ([SENSe<Ch>:]CORRection:COLLect:DELete).
Calibration types: One-port Normalization (reflection), using an open (REFL) or a short (RSHort) standard, Full One Port, Two-port Normalization (transmission, FRTRans), One Path Two Port, TOSM, TOM, TRM, TRL, TNA, TOSM with unknown through.
Port numbers of the analyzer. For an n-port calibration type (n = 1 to 4), n port numbers must be specified. If more than n numbers are defined, the spare numbers (the last ones in the list) are ignored. Entering less than n numbers causes an error message.
Device-specific, no query. Use [SENSe<Ch>:]CORRection:COLLect:METHod? to obtain a list of all calibration types for channel <Ch>.
Calculates the system error correction data from the acquired one or two-port measurement results ([SENSe<Ch>:]CORRection:COLLect[:ACQuire]), stores them and applies them to the calibrated channel <Ch>. To avoid incompatibilities, older system error correction data is deleted unless it has been transferred into a cal pool (MMEMory:STORe:CORRection <Ch>, '<file_name>').
This command is the ZVR-compatible equivalent of [SENSe<Ch>:]CORRection:COLLect:SAVE:SELected. It must be used in combination with the ZVR-compatible commands for calibration method and standard selection; see example below.
Confirmed, no query
CORR:COLL:METH REFL1
Select a one-port normalization at port 1 as calibration type.
CORR:COLL OPEN1
Measure an open standard connected to port 1 and store the measurement results of this standard.
CORR:COLL:SAVE
Generates a set of default system error correction data for the selected ports and calibration type. The default data set corresponds to a test setup which does not introduce any systematic errors; none of the measurement results acquired previously ([SENSe<Ch>:]CORRection:COLLect[:ACQuire]) is taken into account.
The main purpose of the default correction data set is to provide a dummy system error correction which you can replace with your own, external correction data. You may have acquired the external data in a previous session or even on an other instrument. If you want to use the external correction data on the analyzer, simply generate the default data set corresponding to your port configuration and calibration type and overwrite the default data. For details refer to the program example below.
This command must be used in combination with the ZVR-compatible commands [SENSe<Ch>:]CORRection:COLLect:METHod and [SENSe<Ch>:]CORRection:DATa. Use [SENSe<Ch>:]CORRection:COLLect:SAVE:SELected:DEFault if you want to use ZVA-specific calibration commands or if you want to calibrate more than 2 ports.
Select a one-port normalization at port 1 with an open standard as calibration type.
CORR:COLL:SAVE:DEF
Calculate a dummy system error correction for the normalization at port 1. The dummy system error correction provides the reflection tracking error term 'SCORR3'.
CORR:DATA? 'SCORR3'
Query the dummy system error correction term. The response is a 1 (written as 1,0 for the real and imaginary part) for each sweep point (no attenuation and no phase shift between the analyzer and the calibration plane).
CORR:DATA 'SCORR3',<ASCII_data>
Replace the dummy system error correction term with your own correction data, transferred in ASCII format.
Calculates the system error correction data from the acquired measurement results ([SENSe<Ch>:]CORRection:COLLect[:ACQuire]:SELected), stores them and applies them to the calibrated channel <Ch>. To avoid incompatibilities, older system error correction data is deleted unless it has been transferred into a cal pool (MMEMory:STORe:CORRection <Ch>, '<file_name>').
Generates a set of default system error correction data for the selected ports and calibration type. The default data set corresponds to a test setup which does not introduce any systematic errors; none of the measurement results acquired previously ([SENSe<Ch>:]CORRection:COLLect[:ACQuire]:SELected) is taken into account.
CORR:COLL:SAVE:SEL:DEF
Calculate a dummy system error correction for the normalization at port 1. The dummy system error correction provides the reflection tracking error term 'REFLTRACK'.
CORR:CDAT? 'REFLTRACK',1,0
CORR:CDAT 'REFLTRACK',1,0,<ASCII_data>
Selects a connector type at a specified port <port_no> and its gender. In contrast to [SENSe<Ch>:]CORRection:COLLect:CONnection<port_no>, this command uses a string variable to identify the connector type.
Connector type (string parameter) and gender of the connectors. The gender designation MALE | FEMale is not necessary (and ignored) for sexless connector types.
'N 50 Ohm',FEM for all ports.
*RST; CORR:COLL:SCON1 'N 75 Ohm', MALE; SCON4?
Change the connector type at port 1 from 'N 50 Ohm', FEM to 'N 75 Ohm', MALE. The connector type at the other ports is also changed to N 75 Ohm, however, the gender (female) is maintained. CORR:COLL:SCON4? returns 'N 75 Ohm', FEM.